home *** CD-ROM | disk | FTP | other *** search
/ Garbo / Garbo.cdr / mac / sys7 / pwrswtch.sit / PwrSwitcher 1.0a2 Doc next >
Encoding:
Text File  |  1991-08-08  |  4.9 KB  |  83 lines  |  [TEXT/ttxt]

  1. About PwrSwitcher
  2.  
  3. Version 1.0a2, August 7, 1991
  4. ⌐ 1991 David B. Lamkins
  5. All rights reserved
  6.  
  7.  
  8. Copying and Use
  9.  
  10. PwrSwitcher may be freely distributed so long as it includes this documentation. PwrSwitcher may not be sold. The user must assume all risk of loss resulting from use of PwrSwitcher.
  11.  
  12.  
  13. Description
  14.  
  15. PwrSwitcher is a system extension that lets you cycle through the active programs by pressing the power key on your ADB keyboard. This release of PwrSwitcher requires System 7, and a keyboard with a power key.
  16.  
  17. With the shift key down, PwrSwitcher cycles through active programs in reverse order.
  18.  
  19. The control key may be held down while invoking PwrSwitcher ╤ it has no effect on operation. Perhaps this will help RadiusWare users avoid triggering PwrSwitcher and Cursor Beacon at the same time.
  20.  
  21.  
  22. Similar Programs
  23.  
  24. PwrSwitcher is most similar to Switch by W. J. Bock. Unfortunately, the only version of Switch that I've ever seen chokes when File Sharing (or any other background╨only application) is active. [Incidentally, AppSwitcher and JustClick also have the same problem, at least for the moment.]
  25.  
  26.  
  27. Installation
  28.  
  29. Drag the PwrSwitcher icon to your System Folder, and allow the Finder to place it in the Extensions folder. PwrSwitcher will be installed the next time you restart your machine. To remove PwrSwitcher, move it somewhere else (not inside the System Folder) and restart your machine. You can prevent PwrSwitcher from installing itself by pressing the mouse button just before its icon appears. (I╒ve always thought that this approach is bogus, but it╒s a ╥standard╙╔)
  30.  
  31.  
  32. Compatibility
  33.  
  34. For now, PwrSwitcher only works under System 7, and with keyboards that have a power key. I may remove these restrictions in a future release.
  35.  
  36. If you use PwrSwitcher under System 6 or earlier, it will not install itself, and will show a ╥dimmed╙ version of its icon during startup.
  37.  
  38. If you use PwrSwitcher under System 7 on a keyboard without a power key, it will install normally, but you won╒t be able to access its functionality.
  39.  
  40. RadiusWare users have found that PwrSwitcher and Cursor Beacon both respond to the power key. As of v1.0a2, I╒ve changed PwrSwitcher so you can also trigger it with the control key down. I hope this will keep Cursor Beacon from doing its thing at the same time.
  41.  
  42. PwrSwitcher coexists quite nicely with Paul Mercer╒s Programmer╒s Key, which also uses the power key. PwrSwitcher only does its thing when none of the modifier keys (except maybe the Caps Lock key) are pressed, while Programmer╒s Key only does its thing when one or more of the modifier keys are pressed.
  43.  
  44.  
  45. Known Problems
  46.  
  47. One thing that I find annoying is that PwrSwitcher makes ╥hidden╙ layers visible ╤ I╒ll try to fix this, but it depends upon access to the Layer Manager, which Apple hasn╒t documented yet.
  48.  
  49.  
  50. Feedback
  51.  
  52. I would appreciate comments and suggestions regarding PwrSwitcher. I can be reached at the following addresses:
  53.  
  54.    AOL: DBLamkins
  55.    Internet: lamkins@cs.umb.edu (not a permanent account)
  56.  
  57.  
  58. Caution
  59.  
  60. I have not yet registered PwrSwitcher╒s creator type, 'PWRS'. You may find that this creator conflicts with an existing application on your disk. If this happens, PwrSwitcher may take on the other application╒s icon, or the other application may take on PwrSwitcher╒s icon.
  61.  
  62. If this PwrSwitcher╒s creator conflicts with another application, you should remove all copies of PwrSwitcher from your disk and rebuild the desktop by inserting the disk (or restarting from the disk, if it╒s your startup volume) with the Command and Option keys held down until you get the dialog asking for permission to rebuild the desktop. I would also appreciate a note informing me of the conflict.
  63.  
  64.  
  65. Future Plans
  66.  
  67.    Ñ Provide an alternate activation key for other keyboards.
  68.    Ñ Support operation under System 6 Multifinder.
  69.    Ñ Provide a way to ╥mark╙ and switch directly to an application.
  70.    Ñ Skip over ╥hidden╙ layers.
  71.  
  72.  
  73. Release History
  74.    1.0a1    Aug 3, 1991:    First release.
  75.    1.0a2    Aug 7, 1991:    Ignore Control key so RadiusWare users can cycle without triggering Cursor Beacon. Cycle backwards through processes when Shift key is down.
  76.  
  77.  
  78. Implementation
  79.  
  80. PwrSwitcher patches the _KeyTrans trap, looking for a keydown on the power key. When this happens, PwrSwitcher calls the Process Manager to get the next process following the front process, and brings that process to the front. Background╨only processes are skipped.
  81.  
  82. PwrSwitcher was written entirely in THINK Pascal, using an INIT shell of my own design. The INIT shell allows you to install patches and VBL tasks in a straightforward way without resorting to inline code. The shell also provides a Quickdraw world so the shell can display the init icon, and so the init can (if absolutely necessary, although INITs aren╒t supposed to do this) display windows or dialogs. The shell provides a mechanism for the INIT to easily undo everything and bail out if an error occurs partway into the installation.
  83.